home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / prog / re11.arj / RE.DOC < prev    next >
Text File  |  1994-02-10  |  5KB  |  171 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.            //////////   ////////  /////////      ////////   //////
  20.          ///      //  //        //             //         //    //
  21.        //////////   /////     /////////  //  /////      //    //
  22.       ///    //    //               //      //         //    //
  23.     ///     ///  ////////   ////////      /////////  ///////
  24.  
  25.  
  26.  
  27.                                Version 1.1
  28.  
  29.                 (c) Copyright  1994, Blueview Software.
  30.                            ALL RIGHTS RESERVED
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. INTRODUCTION
  55.  
  56.   RES-ED is a programmers utility that allows the creation of resource
  57. files. Resource files are commonly used for storing information that would
  58. normally be in various files or coded into the actual program. When programs
  59. reach a certain size this information becomes difficult to handle. RES-ED
  60. allows you to keep all this information in an easy accessible format.
  61.  
  62.   Resource files can be used for storing video drivers, help information,
  63. map files (for game programmers), and various other types of information.
  64. RES-ED can also be used to create installation files, a general purpose
  65. loader can be written to access the contents of a resource file and extract
  66. the information to appropriate drive/directory. A simple (documented) format
  67. is used to build resource files that can be accessed from any programming
  68. language.
  69.  
  70.  
  71.  
  72.  
  73.  SYSTEM REQUIREMENTS:
  74.  
  75.   - DOS 3.0 or higher
  76.  
  77.  
  78.  
  79. CUSTOMER SERVICE
  80.  
  81.      If you have any questions, comments, or suggestions,
  82.      Blueview Software can be contacted by:
  83.  
  84.      Voice - (416) 757-7944
  85.  
  86.      BAUDEVILLE BBS (416) 283-0114  (Blueview Conference)
  87.      CAP/CANADA BBS (416) 287-0935  (Blueview Conference)
  88.      CAP/USA    BBS (708) 854-0255  (Blueview Conference)
  89.  
  90.      Shareware Conferences - RIME, INTELEC, NANET, CITY2CITY, FIDONET,
  91.                              and ILINK. Leave message to NICK ONOUFRIOU.
  92.  
  93.      CompuServe: >INTERNET:nick.onoufriou@rose.com
  94.  
  95.      Internet: nick.onoufriou@rose.com
  96.                nick.onoufriou@bville.gts.org
  97.  
  98.      Fido net-mail: 1:250/304
  99.  
  100.      Surface Mail  - Blueview Software
  101.                      2300 Lawrence Ave. East BOX 80551
  102.                      Scarborough, Ontario
  103.                      CANADA  M1P 2R0
  104.  
  105.      NOTE: All mail _will_ be answered. If you do not receive a reply
  106.            within a few days please try again, mail does get lost.
  107.  
  108.  
  109.  
  110. USING THE EDITOR
  111.  
  112.  RES-ED main menu consists of three options:
  113.  
  114.      1) Edit Resource file - used to edit an existing resource file
  115.      2) Create Resource file - used to create resource files from scratch
  116.      3) Exit
  117.  
  118.  
  119.  If a resource file is selected a new menu will appear listing the contents.
  120. No contents will be displayed if your are creating a new resource file. From
  121. this menu you can:
  122.  
  123.     [A] - Add a file
  124.     [I] - Insert a file
  125.     [D] - Delete an item
  126.     [R] - Replace an item
  127.     [X] - Extract the item to disk. ie. Convert item to a file.
  128.   [ESC] - Quit
  129.     [S] - Save the contents of the resource file to disk
  130.    [F2] - Edit the "type" field of the resource item
  131.    [F3] - Edit the "id" field of the resource item
  132.  
  133.  
  134. Once a file is imported into the editor it referred as an item. Each item has
  135. the following fields:
  136.  
  137.     TYPE - A value ranging from 0 to 65000 indicating what the contents of
  138.            this item may include. Default value is 0.
  139.  
  140.     ID   - 12 character field used for to describe the item. The items
  141.            original filename is the default value.
  142.  
  143.     OFFSET - The absolute file position where the contents of the items are
  144.              located.
  145.  
  146.     LENGTH - The size (in bytes) of the items contents
  147.  
  148.     MODIFIED - Used to indicated if that Item has been replaced, or if the
  149.                contents of the TYPE or ID fields have been changed.
  150.  
  151.  
  152.  
  153. ADDING RESOURCE FILES TO YOUR PROGRAMS
  154.  
  155.   Once a resource file is created you can use it in your own programs. Each
  156. resource file created with RES-ED contains a simple header. The first three
  157. bytes contain the characters "RES" followed by an unsigned integer (two
  158. bytes) indicating the number of items.  Each item consists of 22 bytes
  159. indicating ITEM TYPE (2 bytes), ID (12 bytes), OFFSET (4 bytes), and LENGTH
  160. (4 bytes). Although not required, the demo programs can be used to better
  161. understand the resource file format.
  162.  
  163.  
  164. REGISTERING RES-ED
  165.  
  166.   RES-ED is part of series of programmers utilities, registration entitles
  167. you to a fully functional RES-ED (no 10 item limitation) as well full
  168. registered versions of Raster Master and Raster Utilities. See ORDER.TXT
  169. and CATALOG.TXT for additional information.
  170.  
  171.